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Revision History: 
rev. 1.0 Initial release 
rev. 1.1 Stan sound call added, 
rev. 1.2 Changed Start sound call. 

Added added a description for generators. 

Added Sound tools status call for sound tools startup call. 

Added individual generator status call, 
rev. 1.3 Updated the Start Sound call to include the new parameter 
block. 

Added FFSoundDoneS tatus function ($14). 

rev. 1.4 Changed the Frequency formula in the FFStartSound call to use integer values 
instead of floating point values for the frequency register calculations. 

Changed the descriptions in the low level routines to access the DOC registers or 
ram. 

rev. 1.5 Updated the Generator/Mode word parameter in the FFStartSound call, 
rev. 1.6 Changed the paramerter block format for the FFStartSound call to conform with 
the word aligment of parameters passed to functions. 

Reserved oscillators thirty and thirty one for use by Apple Computer. These two 
oscillators can NOT be used by application programs, 
rev. 1.7 Updated stop sound call to show 1 stop corresponding generator. 

Added examples for each of the Sound Tools function calls. 
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1.0 Introduction. 


The sound tool package gives developers the ability to access 


I/O addresses. The Cortland sound hardware comes In two 
configurations. The first configuration is 100% compatible 
with the Apple //# sound capabilities. In this mode 



The second configuration requires the Ensoniq (DOC) digital 

















The DOC ram Is used to store waveforms which will be used by the 

DOC for sound generation. The DOC is the work horse of the sound system. 

With this chip we can create sounds of any pitch and duration. A register 

breakdown of the DOC follows: 

£(D8(EOD0q) IBOj]0Q®O (DcOOOfflQfltr CODfltp 
QD00 ®s®Q0®qd 


Oscillator #XX 

Frequency low 

Frequency high 
Volume control 
Data Sampling 
Ram Ptr.'pg. no. 
Control register 
Resolution/Table size 


{ Oscillator number 0 | 
Oscillator number 1 
Oscillator number 2 | 


e • e 

• • • 




Oscillator Interrupt enable 

□ 

Oscillator triable regisTer | 

□ 

Analog to digital converter! 


DOC register table 


REG# 

Function 

07 



IlijElj 

m 

EE1 

PIIS 

00-IF 

FREQ LOW 

FL7 

nn 

BS 

BS 

Ba 

ran 

m 

BE 

20-3F 

Treqhi 


122 

yjg 

IgjS 

Iff! 


Ba 

I2S 



MiM 

m 

1TI 

ill 


129 

m 

BO 

KSUl 





mi 


I’.Vl 

yi 

^751 

80-OF 

WAVEFORM TABLE PTR 

P7 

EO 


■ZI 

■23 

JTsM 

CD 

l^»l 

AO-BF 

CONTROL 

K2S 

as 

m 

be 


ua 

m 

EO 

CO-DF 1 

BANK SEL/TBL. SIZE/RES. 

K9 

E3 

ia 

ko 

■a 

B3 

CO 

cu 

EO 

OSCILLATOR INTERRUPT 

RQ 


04 

03 

02 

01 

m 

jn 

t ei 

OSCILLATOR ENABLE 

mm 

MM 

El 

EO 

E2 

HI 


mm 

E2 

A/D CONVERTER 

S7 

in 

ss 

S4 

S3 

E3 

ma 

soj 


Please refer to the Ensoniq DOC Ers for a detailed description of the part. 

The analog section contains all the circuitry needed to amplify and 
filter the signal coming from the Sound Qlu or the DOC, which will be sent 
to the speaker. 

Finally, the sound connector gives developers the ability to design 
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interface cards, which can take the tones generated by the DOC and modify 
them further. Two examples of possible sound cards are, programmable 
filter stereo interface cards, and sound sampling cards. The remainder of 
this document will deal with a detailed description of the Sound tool calls 
and how they can be used to access the hardware to generate sounds. 
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1.1 Sound Tools Definitions. 

An oscillator Is defined as the basic sound generating unit in the DOC. 
The DOC contains thirty two oscillators; each of which can function 
independently from all the other oscillators. 

One of the modes the DOC can be set to is called swap mode. In this 
mode each pair of oscillators is grouped together to form a swap pair of 
oscillators. This is the mode used by the Free Form synthesizer to generate 
sounds. Each of these swap pair of oscillators is called a Generator. There 
are fifteen generators defined in the Cortland sound system. Oscillators 
thirty and thirty one a reserved for use by Apple Computer and should not be 
used by application programs’. An oscillator to generator translation table 
has been defined to get the generator number corresponding to a particular 
oscillator number. 

Before a generator can be accessed, a sound tools startup call must be 
made. This call assigns a work area for the sound tools. The work area is 
broken down into sixteen groups of sixteen bytes each. Each sixteen byte 
group is defined to be a generator control block (GCB). The first byte of 
each GCB is defined to contain the synthesizer mode being used by that 
generator. The low nibble of the byte contains the mode. The high nibble Is 
reserved for use by the system. The remaining fifteen bytes are user 
definable. 

The Sound tools set is made up of four main blocks; the Free Form 
Synthesizer; the Note Synthesizer, the Note Sequencer and the Instrument 
generator. 
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1.0 Free form synthesizer tool set definition. 

As mentioned before, the tool set gives a developer the ability to 
control the sound hardware without having to access the hardware registers 
directly. The tool set Is defined from the point of view of a complete sound 
system. The tool set must be able to read and write to ram, read and write 
to the DOC registers and raise and lower the volume. 

The sound tool package is accessed through the Tool locator. This 
tool locator lets an application set up parameter lists on the stack, call tool 
functions and return to the caller with return parameters on the stack. It is 
the responsibility of the caller to make room on the stack for values which 
may be returned to the caller from the tool calls. 

The Sound Tool set has a tool number assigned to it. With this .tool 
number the Tool Locator can access the sound tools. 

The sound tool calls are broken down into two groups. The first group 
of calls is made through the Tool Locator. Each of these calls has a function 
number assigned to it. With this function number the Tool locator knows 
which function to call within the tool set. All parameters for these calls 
are passed on the stack. Function results are returned to the caller In the 
stack. The number of parameters will vary depending on the type of call 
being made. It is the responsibility of the individual tool functions to do 
the stack manipulation to keep it aligned. Also the accumulator and the 
carry bit will reflect the success or failure of the function call. Please 
refer to the "Tool locator* documentation for a detailed description of the 
interface. 

The second group is a set of routines which can be accessed through a 
jump table located somewhere in ram. Parameters are passed to these 
routines In the processors registers. Results from these calls are passed 
back In registers. The following list gives a breakdown of the sound tools. 
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Sound tool function calls: 

oundBootlnit ■ $01 
SoundStartup - $02 
SoundShutdown • $03 
SoundVersion - $04 
SoundReset - $05 

SoundToolStatus • $06 
WriteRamBlock - $09 
ReadRamBlock ■ $0A 
GetTableAddress - SOB 
GetSoundVolume - $0C 
SetSoundVolume - $0D 
FFStartSound - $0E 
FFStopSound - $0F 
FFSoundStatus - $10 
FFGeneratorStatus - $11 
SetSoundMIRQV « $12 
SetUserSoundIRQV « $13 
FFSoundDoneStatus® $14 


©ad Register 
Write register 
Read Ram 
Write Ram 
Read Next 
Write Next 


The low level routines are entered through a Jump table. The table address can be obtained 
through a call to "Get Address' function. The format of the jump table Is as follows: 


Offset 


Read Register $00 
Write Register $04 
Read Ram $08 
Write Rem $0C 
Read Next $10 
Write Next $14 
Osctable $18 
Generator table $1C 
Gcb.addr. table $20 


Addr low 

Addr high 

Bank 

soo 

Addr low 

Addr high 

Bank 

$od 

Addr low 

Addr high 

Bank 

$00 

Addr low 

Addr hiah 

Bank 

$00 

Addr low 

Addr hiah 

Bank 

$00 

Addr low 

Addr high 

Bank 

$00 

Addr low 

Addr high 

Bank 

$00 

Addr low 

Addr high 

Bank 

SCO 

Aoar low 

Aaar hign 

Ban* 

$00 
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SmalELaMMi function jfpi 

This call is made on system powerup or system reset to bring the 
sound hardware to powerup state. The call Is made by the firmware and can 
NOT be made by an application programl This call will reset all of the DOC 
sound memory to $80, zero out the sound tools work areas, halt all the 
oscillators and turn the volumes down to zero. 

Error Codes: None 
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SmalSJjiiua 

The Sound tools startup call is made by an application to set up a 
sound tools work area. This call must be the first call made by the 
application program. The call Initializes a work area to be used by the 
sound tools. The pointer to the work area must be passed as a parameter to 
the call. This work area will be used as a zero page. This page will be 
allocated by calling the memory manager. It must be page aligned and 
locked until a shutdown call is made. The stack configuration for the call is 
as follows: 


Stack configuration for SAppInit 
Wap:word ; Work area pointer in Bank $00 


Error Codes: 

$10 - No DOC chip found 

$18 - Sound tools already started 

Example: 

PEA Label ; One page work area in bank $00 
_SoundStartup ; Sound Tools startup macro call 
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function #03 

This call will shut down the sound tools. It shuts off all of the 
oscillators resets the WAP back to $0000 and zeros out the sound tools 
work memory to zero. There are no parameters passed to the call on the 
stack and no values returned It is the responsibility of the application to 
relase the memory allocated to the work area back to the memory manager. 

Error Codes: None 
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HQMMlJiLilm function #04 

This call returns the Sound tools version number. The format of the 
version number is as specified in the Tool Locator documentation. There are 
no parameters passed to the call but room must be made on the stack for one 
word of version information returned to the caller. 

Error Codes: None 

Example: 

PEA $0000 ; make room for version 

JSoundVersion ; Sound Tools version call 
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SmmMuMl junction #os 

This call stops all of the generators which may be generating sound. 
This call can not be used by an application to stop sound generation. It is 
intended for use by the firmware to control the shutdown of generators. An 
application program should use the stop sound call to shut down a 
generator. This call does not require any parameters on the stack or returns 
any values back to an application. This call does not update the active 
generators flag. 

Error Codes: None 
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hmrAl ^n #os 

This call will return the status of the sound tools.It returns a $FFPF 
if a SAppInit ($02) call has been made; otherwise It returns $0000. Room 
must be made on the stack for a one word value which will be returned to 
the caller. 

Error Codes: None 

Example: 

PEA $0000 ; make room For sound tools status 

_SoundToolStatus ; Sound Tools Started status 
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The Write Ram Block call will write a specified number of bytes from 
system ram Into DOC ram. The parameter list is made up of the starting 
address, and a byte count to move. If the sum of the starting address and 
the byte count are greater than 64K, an error status will be returned. 

Stack configuration for write ram block: 

Sourc@_ptr.Long word ; data source start address 
DOC.startrword ; DOC buffer start address 

Byte_count:word ; number of bytes to move 

Error Codes: 

$0004 - DOC address range error. 


Example: 

Pushlong Label 
PEA DOC.buff 
PEA byte.count 
WriteRamBlock 


Source buffer address 
DOC ram buffer start address 
number of bytes to move 
Write ram block macro call 
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BlMBiEDMfixl fimcUon #0A 

This call reads any number of locations from the 64K DOC ram area 
into a user specified buffer. The number of bytes and the starting location 
must not add up to a value greater than 64K, otherwise a range error will be 
generated. The format of the parameter list Is as follows: 

Stack configuration for Read Ram block 

Dest_ptr:Long word ; Destination system buffer address 
DOC.start word ; Source start address In DOC ram. 
Byte„count:word ; number of bytes to move 

Error Codes: 

$0004 - DOC address range error. , 


Example: 


Pushlong Label 
PEA DOC.buff 
PEA byte.count 
ReadRamBlock 


; System ram buffer start address 
; DOC ram buffer start address 
; number of bytes to move 
; Read ram block macro call 
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GetlahlfiAd difiLSi tmsUmMM 

This call returns the jump table address for the fast access routines. 
The table of low level routines Is defined as follows: 

Ofts@t 

Hoad Register $00 

Writs Register $04 
Road Ram $08 
Write Rem $OC 
Read Next $ 10 
Write Next $14 
Osctebie $18 

Generator table $1C 

Geb.addr. table $20 

With the exception of the last three entries, each of these routines 
are defined later In this document. 

The Osctable translates from generator number to oscillator number, 
. The oscillator number returned through this table is the first oscillator of 
the pair. The Gcb address table points to the first location of the GCB 
corresponding to a generator, and the Generator table translates from 
oscillator number to generator number. 

The application making this call must make room on the stack for a 
long word returned from the call. 


Addr lew 

Addr high 

Bank 

$00 

Addr low 

Addr high 

Bank 

$00 

Addr low 

Addr hioh 

.Sink _ 

$00 

Addr low 

Addr hioh 

Bank 

$00 

Addr tow 

Addr hioh 

Bank 

$00 

Addr low 

Addr high 

Bank 

$00 

Addr iow 

Addr hioh 

Bank 

$00 

Addr iow 

Addr liigh 

Bank 

$00 

ASWRJw 

Aoor mgrT 

' ■ - HSSTift • ”1 

:;oo 


Error codes:None 


Example: 

Pushlong $00000000 ; Make room for long address 

GetTableAddress ; Get table address macro call 


Sound Tools ms Rev. 1.7 June 26, 1986 12:15 PM CoofkfeotM 


page 17 


fiftl&umdYBlum EmelLpn soc 

This call will read the volume setting for a generator. The possible 
range of values read back are between $00*$FF. All eight bits are valid for 
DOC volume registers. 

If the generator specified is greater than fourteen ($0E), then the 
system volume setting will be returned. The hardware for the system 
volume control uses the low nibble of a byte to set the volume. In order to 
be consistent with the DOC volume registers, we map the low nibble Into the 
upper nibble of a byte. We end up with each possible system volume setting 
mapped sixteen times. Volume settings $00-$0F correspond to system 
volume setting $00, values $10-$1F correspond to system volume $01, etc. 

Room must be made on the stack for a one word value which will be 
returned from the call. 

Stack configuration for Get Volume call: 

Gen_number:word ; Generator number 


Error codes:None 


Example: 


PEA $0000 
PEA gen.num 
GetSoundVolume 


room for volume setting 
Generator number 
Get volume macro call 
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MlStmMlshmA Emiciion sod 

The set volume call changes the volume setting for the volume 
registers In the DOC and the system volume. Generator numbers $00-$0E 
will set the volume on pairs of generators in the DOC. Generator numbers 
$0P or greater will set the system volume control. The range of values for 
the volume setting are $00-$PF. The DOC volume registers use all eight bits 
of resolution. The system volume control will use the upper nibble of the 
setting to determine the setting. 

Stack configuration for SetVolume call: 

Volume_setting:word ; new volume setting 

Gen_number:word ; Generator number to set 

Error codes: None 
Example: 

PEA New.volume ; new volume setting 

PEA gen.num ; Generator number 

_SetSoundVolume ; Get volume macro call 
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Emiglion SOE 

This call will enable the DOC to start generating sound on a particular 
generator based on the parameter list passed to the call. If a generator is 
already active and a start sound call is made for it, then the previous sound 
generation process will be terminated and the new sound process will be 
started. The parameter list for the Start Sound call is as follows: 


The stack configuration for StartSound call: 

GenNumbyFFsynthrword ; Channel noJgenerator number/mode 

-"—'TO C channel number ($0-$F) 

Generator number ($0-$E) 
•Reserved (must be $0) 
•Synthesizer mode ($0-$F) 

FFSynth - $01 


bl 5 bO 


f i 'l I til I 1 ITT 


Pblock_ptr:Longword 
The parameter block format: 
Wave_start:Longword 
Wave_size:word 
Freq_offset:word 
DOC_buffer:word 
DOC_buffer_slze:word 
Nextw_addr:Longword 
Velume„8etting.-word 


; Parameter block pointer 

; Start address of wave 
; Waveform size In pages 1 
; waveform playback frequency 2 
; DOC buffer start address 4 
; DOC buffer size code 3 
; Next wave parameter block ptr 5 
; DOC volume setting. 4 


1. The smallest which can be played back Is one page. A waveform size of 

$FFFF will play back 65536 pages. 

2. The Frequency register setting can be calculated with the following 
formula: FR-((32*PF)/1645), where PF-Playback frequency in hertz 
& FR-Frequency register value. 

3. This code assigns a size for the DOC buffer used for the waveform being 
played. One of these buffers Is assigned for each oscillator In the 
generator pair being used to play the waveform. The DOC start address 
for the second osdilator Is assigned at start address + DOC buffer size. 

4. For further Information on these settings, please refer to 
the Erooniq DOC ERS. 

5. These three bytes point to another waveform parameter block. If the 

setting of the Nextw_addr and Nextw_bank are zero, then there are no 
more Free-Form synthesizer waveforms to be played back through this 
start sound call. 


Error Codes: 

$0012 - NO SAppInlt call made 
$0013 - Invalid generator number 
$0014 ■ Synthesizer mode error 
$0015 - Generator busy 
$0017 - Master IRQ not assigned 
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Example: 


Pblock 


Next.wave 


PEA Gen.mode 
Pushlong Pblock 
FFStartSound 


Generator/mode word 

Parameter block pointer 

Free Form Synth start sound macro 


» ♦ • t 

equ * 

DC l4*Wave .start* 

DC l2*Wave.size’ 

DC 12’DOC.Freq' 

DC I2’D0C.buffer* 
DC 12’DOC.buf.code* 
DC 14’Next.wave' 

DC 12’DOC.volume' 


Waveform parameter block 
Waveform start address 
Wave size In pages (1 page min.) 
DOC frequency register value 
DOC ram buffer start address 
DOC buffer size code $00-$07 
next wave parameter block ptr. 
DOC volume register setting 



; Next wave parameter block 
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ESLSdm&&uM Eyncilon sop 

This call will stop sound generators which may be running. A 
generator running is defined to be one playing a waveform or one which has 
completed playing a waveform. The generator will stay busy until a stop 
sound call Is made, even though waveform playback has ended. Depending on 
the setting of a sixteen bit flag passed as a parameter to the function any of 
fifteen generators will be stopped if running. Each bit position in the stop 
generator mask corresponds with a sound generator. Bit zero corresponds to 
generator zero, bit one corresponds with generator number one, and so on. 
There are only fifteen generators defined. This call does not return any 
error information back to the caller. The format of the parameter list is as 
follows: 


Stack configuration for Stop Sound: 

Gen_mask:word ; generators to stop 


STOP SOUND MASK 


0 

E 

D 

C 

B 

A 

9 

8 7 

6 

5 

4 

3 

2 

1 

0 


F* 


Z 


aenerator 
aenerator 
generator 
aenerator #c 
aenerator #4 
aenerator #5 
aenerator #6 
aenerator #7 
aenerator #8 
aenerator #9 
aenerator #A 
aenerator #B 
aenerator »C 
aenerator #D 
aenerator #E 


Must be zero 


1 • stop corresponding generator 
0 ■ leave It generator alone 


Error Status: None 
Example: 

PEA Stop.mask ; mask for stop generators 
_FFStopSound ; Free Form Synth stop sound 


f 

v. 
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This call will return the status of the all fifteen generators. Any bit 
position In the status word returned from the function call signifies that 
the corresponding generator Is active. There are no parameters passed to 
the function. The format of the word returned form the call is as follows: 

m # 

Generators status word m 

o| EIdIC I B I A I 9 | 81 7 I 6 |5 I 4 I 3 2 I 1 I 0 


g enerator #0 
enerator #1 
Generator #2 
Generator #3 
Generator #4 
Generator #5 
Generator #6 

g enerator #7 
enerator #8 
Generator #9 
Generator #A 

g enerator #B 
enerator wC 

g enerator #D 
enerator #E 


Must be zero 


Generator is assigned/busy 
Generator free 


Error Status: None 
Example: 

PEA $0000 ; make room for status word 

_FFSoundStatus ; Generators status macro call 
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Functional i 

This call will read the first two bytes of the QCB corresponding to 
the generator specified. Room must be allocated on the stack for the word 
returned from the call. For the Free form synthesizer these two bytes have 
the following format: 

_$01 ■ Last block of 

wave loaded. 

$00 - Gen. available 

I-—— — ——— -*— $01 - Free Form synth. 

$02 - Note Synth. 


--Channel $00-$0F 

--Gen $00-$0E 

x 


bit 15 bit 0 

Stack configuration for Gen. status call: 

Gen_number:word ; generator number for status 

Error Codes: None 

Example: 

PEA $0000 ; room for Generator status 

PEA Gen.number ; Generator number 
_FFGeneratorStatus; generator status macro calf 




i » r i ”'i 
0 0 0 Mode 

f t f f t f 




rrnr 

Chan. NO 

™X_X_U 




m —t 

Gen NO. 

-j—i—i 
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Sfii S mm dMiaai • Functional? 

This calls sets up the entry point Into the sound interrupt handler, 
This routine will ;be accessed every time an Interrupt is generated by the 
DOC. The processor will be In full native mode when the sound interrupt 
handler is entered. The parameter list for a set sound IRQ vector is as 
follows: 

Set Master Sound Irq vector stack config. 

SMasterJrq:tongword ; Sound Master IRQ vector 

Error Codes: None 
Example: 

Pushlong Master.irq.vect; Set master irq vector macro 
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Ejunction=si3 

This calls sets up the entry point tor a users synthesizer interrupt 
handler. When- an Interrupt occurs for a user defined synthesizer then 
control will be passed to the ram based synthesizer code through this 
vector. The old vector Installed will passed back to the caller. This old 
vector must be preserved by the caller. If control is passed to the user 
vector and the synthesizer mode Is not his, then control will passed further 
down the chain through this vector. Control will be passed through a JSL, 
therefore the user must return control through an RTL instruction. Room 
must be made on the stack for long word returned on the stack. 

Stack configuration for Set User's Sound IRQ vector. 

User_irq_vector:Longword ; New user IRQ vector 


Error Codes: None 


Example: 


Pushlong $00000000 
Pushlong New.vector 
SetUserSoundIRQV 


; make room for old vector 
; new vector 

; set user sound irq vector macro 
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Ef3mMRQm-Sli,lm Emelian. »i4 

This call will return the status of the Free Form synthesizer sound 
playing status. ' If the generator specified is currently playing out a 
waveform, then the status returned to the caller will be $0000. If the 

generator Is done playing then the status will be $FPPF. Room must be made 
on the stack for one word of status returned to the caller. 

Stack configuration for FFSoundDoneStatus 

Gen_number:word ; Generator number 

Error codes: 

$0013 - Invalid generator number 

Example: 

PEA $0000 ; Make room for status 

PEA Gen.number ; Generator number to check 
^FFSoundDoneStatus; FFsynth Sound done stat. macro 
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Bgari-tefllaler** 

This low level routine lets an application read any DOC register. The 
routine is entered through the Jump table provided by the "GetTableAddress' 
function call. This call will return to the caller through an RTL instruction. 

After this call is made the Sound Glu register is left in register access 
mode with auto Increment enabled. 

Through the generator to “oscillator" table, an application can 
assertain the setting of any register corresponding to an oscillator.. 

Import: 

e ■ 0 ; native mode 
m - 1; 8 bit accumulator 
x - 0 ;16 bit index registers 
X - DOC register to read 


Export: 

AL - contents of register requested 
Error codes: None 


DOC register table 


REG# 

Function 

07 

D8 

tB>i 

04 

IDS 

IDS 

01 

Dffl 

00* IF 

FREQ LOW 

FL7 

FL6 

FL5 

FLA 

FL3 

FL2 

FL1 

FLO 

2"6“3F 

FTTESTHl 

Fk7 


FH5 

FW4 

TFSf 

FR? 

fHi 

THtf 

46-5^ 

VGCOTCE 

V7 

vs 

^5“ 


V3 

V£ 

VI 

Vo 

60- 7 F" ' 

data SampLE 

W7 

“wr 

“W5" 

m 

“Wf 

"W2“ 

“WT 

Wo 

8O-0F 

WAVEFORM TABLE PTR 

P7 

P6 

P£ 

P4 

P3 

P2 

Pi 

P0 

AO-BF 

CONTROL 

CA3 


CM 

"COT 

IE 

ws 

Mi 

H 

CO-DF 

BANK SEL/TBL SIZBRES. 

X 

BS 

T2 

T1 

TO 

R2 

R1 

R0 

fcQ 

’OSUIIIATbR INTERRUPT. 

“TSTj 

i 

54 

55 : 

TRT 

51 

55 


El 

OSCILLATOR ENABLE 

X 

X 

E4 

E3 

E2 

El 

E0 

X 

E2 

A/D CONVERTER 

87 

88 

86 

84 

83 

82 

61 

60 


Note: Register types are grouped Into register classes. Within each 
register class, the register number for each oscillator is assigned in 
assending order. For example: the low byte of the frequency register 
for oscillator zero Is register $00, the low byte of the frequency for 
oscillator number is register $01. The high frequency register for 
oscillator number zero is accessed through register number $20, 
oscillator one uses register number $21 etc... The register numbers 
are provided In the table defined above. 
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mM .jJtglalM. ** 

The Write DOC call will write a one byte parameter to any register in 
the DOC chip. The call will be made through the jump table provided 
to the application by the tool call "Get Address". To write to an 
oscillator register corresponding to a generator we get the oscillator 
number from the oscillator table, bump It by one If we want to access 
the odd oscillator of the pair, add the base register of the specific 
register we want to access and then make the write register call 
through the Write register routine address in the jump table. This call 
will return to the caller through an RTL instruction. After this call is 
made the Sound Glu register Is left In register access mode with auto 
increment enabled. Please refer to the "Note" in the Read register 
description for information on register assignments for each 
oscillator. 

© 

Import: 

e - 0 ; native mode 
m - 1; 8 bit accumulator 
x - 0 ; 16 bit index registers 
AL - data to write 
X - DOC register number 

Error codes: None 


DOC register table 


REQ# 

Function 

07 


BS 

m 

03 

02 

OH 

(Bffi 

00-1F 

FREQ LOW 

FL7 

FL6 

FL5 


FL3 

FL2 

FL1 

FLO 

20-3F 

FR5Q. W . . 

FW 

TR5 

TH5 

R4 4 

Trer 

WS 

FH-i] 

TRC 

45-Sf 

VCLLMe ' 

V? 

w§ 


V4 

S/3 

V2 

Vi 

VS 

TP7F“" 

TOTXTOTpnr” 

w? 

W4 

m 

m 


w 

W1 

■“wtr 

80-6F 

WAVEFORM TABLE PTR 

f»7 

P6 

pa 

P4 

P3 

P2 

PI 

PO 

AO-BF 

CONTROL 

"CXT 

CA2 

CAi 

Ca6 

IE 

M2 

Mi 

th 

CO-OP 

BANK SEL/TBL. SIZE/RES. 

X 

BS 

T2 

T1 1 

TO 

R2 

Ri 

RO 

EO 

oscillator iKiteARupT" 

TST 

1 

04 

63 

o2 

Si 

66 

i 

El 

OSCILLATOR ENABLE 

X 

X 

E4 

E3 

E2 

El 

EO 

X 

E2 

A/D CONVERTER 

871 

S6 

S5! 

S4 

S3 

S2 i 

SI 

SO 
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BtfiOnn!! 

This call will read any Ensoniq ram location specified by the caller. 
This call leaves the address pointer register In the Sound Glu In auto 
increment mode and in ram access mode. The call does not do any 
type of error checking on the address, or data. This call exits back to 
the caller through an RTL Instruction. After this call Is made the 
Sound Glu register is left In RAM access mode with auto Increment 
enabled. 


Import: 

e - 0 ; native 
m « 1 ; 8 bit accumulator 
x - 0 ; 16 bit index registers 
X - Ensoniq ram address to'read 

Error codes: None 
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Write, Bam 6 !. 

This call will write a one byte value to any Ensoniq ram location 
specified. • The call does not do any type of error checking on the 
address or data value to be written. This call returns to the caller 
through an RTL instruction. After this call is made the Sound Glu 
register Is left in RAM access mode with auto Increment enabled. 


Import: 

e - 0 ; native 
m - 1 ; 8 bit accumulator 
x - 0 ; 16 bit Index registers 
AL - data value to be written 
X - Ensoniq ram address to write to 

Error codes: None 
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HfiM—Mum 

This call will read the next location pointed to by the Sound Glu 
address register. The previous call must have been a Read register, 
write register, read ram, or a write ram call for this call to work 
properly. Any of these four calls will leave the Sound Glu set to auto 
increment and pointing to DOC register or ram access mode. After the 
read Is made the Sound Glu address/DOC register pointer will be 
incremented to the next location. 

Import: 

None 

Export: 

AL - data byte read 
Error codes: None 
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WrJlt.Mfiil 06 

This call will write one byte of data to the next DOC register or ram 
location depending on the setting of the Sound Glu control register. 
The call will write to DOC registers or ram and then Increment the 
address pointer register in the Sound Glu, if the address pointer 
register was enabled for auto increment. If a Read register, read ram, 
write register or write ram call is made then that call will leave the 
Sound Glu control register In that type of access mode and with auto 
Increment enabled. 

Import: 

AL - byte value to be written 
Error codes: None 
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